home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / dl_serie / updates / 095 / starbox / star_dat / maps.txt < prev    next >
Encoding:
Text File  |  1995-11-25  |  9.5 KB  |  258 lines
  1.                          Anleitung für MAPS V 1.0
  2.                          ************************
  3.  
  4. (C) 1995; Oliver Graf - T.O.M. Software
  5.  
  6.  
  7. 1. Was macht MAPS
  8. -----------------
  9.  
  10.  
  11. Die Aufgabe von MAPS ist es, einem Pointuser einen einfachen Mechanismus
  12. zur Bedienung der Box an die Hand zu geben. Über verschiedene Kommandos
  13. können so Bretter bestellt oder abbestellt werden, die eigenen Pointdaten
  14. verändert werden oder Files angefordert werden, alles Sachen, die sich ohne
  15. MAPS nur in Absprache mit dem Sysop oder nur durch einen zusätzlichen
  16. Userlogin erledigen lassen.
  17.  
  18. MAPS lehnt sich dabei an den ZC-MAPS Standard, der auf dem Z-Netz Treffen
  19. Hamburg '94 entwickelt wurde, an. Dieser Standard ist auf ein maschinen-
  20. lesbares Format ausgelegt worden, daher kann die manuelle Auswertung
  21. einiger Antwort-Mails schwierig bis unmöglich werden. Drängen Sie Ihren
  22. Pointprogrammierer, automatische Auswertungsroutinen für diesen Stan-
  23. dard zu implementieren, es macht auch Ihnen die Arbeit einfacher.
  24.  
  25.  
  26. 2. Die Bedienung von MAPS
  27. -------------------------
  28.  
  29. 2.1 Anschreiben von MAPS
  30. ------------------------
  31.  
  32. Jede Nachricht, die für ein Kommando erzeugt wird, muβ an den User
  33. "maps@box.do.main" gesandt werden. Dabei steht "box.do.main" für die in
  34. Ihrer Serverbox Netzadresse.
  35.  
  36. Im Betreff der jeweiligen Nachricht steht das Kommando und nur das
  37. Kommando.
  38.  
  39. Im Nachrichtentext stehen weitere Parameter, zeilenweise getrennt.
  40. Dies kann entfallen, abhängig vom jeweiligen Befehl.
  41.  
  42.  
  43. 2.2 Befehle von MAPS
  44. --------------------
  45.  
  46. Folgende Befehle sind zur Zeit in MAPS implementiert :
  47.  
  48.  
  49.  Befehl  : ADD
  50.  Aufgabe : Bestellen eines oder mehrer Bretter
  51.  
  52.  Für ADD werden die zu bestellenden Bretter zeilenweise in den Nachrichten-
  53.  text geschrieben. Dabei muβ der Brettname mit einem '/' beginnen.
  54.  Wildcards sind erlaubt, für komplette Brettgruppen kann man beispiels-
  55.  weise "/Z-NETZ/RECHNER/AMIGA/*" schreiben.
  56.  
  57.  ADD liefert als Ergebnis eine normierte Liste der bestellten Bretter
  58.  zurück (siehe LIST).
  59.  
  60.  
  61.  Befehl  : DEL
  62.  Aufgabe : Abbestellen eines oder mehrer Bretter
  63.  
  64.  DEL erwartet im Nachrichtentext die Liste der Bretter, die Sie abbestellen
  65.  wollen.  Dabei muβ ein Brettname mit einem '/' beginnen.
  66.  Wildcards sind erlaubt, für komplette Brettgruppen kann man beispiels-
  67.  weise "/Z-NETZ/RECHNER/AMIGA/*" schreiben.
  68.  
  69.  DEL liefert ein als Ergebnis eine normierte Liste der abbestellten Bretter
  70.  zurück (siehe LIST).
  71.  
  72.  
  73.  Befehl  : DELPM
  74.  Aufgabe : löschen der PMs im User-Postfach
  75.  
  76.  Bei Pointusern, die Ihren Vertreter auf "Kopie" stehen haben, sammeln sich
  77.  mit der Zeit eine Menge PMs im Online-Postfach an. Um dem Sysop eine Freude
  78.  zu machen, sollten Sie hin und wieder die PMs löschen. Dies können Sie mit
  79.  diesem Befehl machen, ohne sich extra als User in die Box einzuloggen.
  80.  
  81.  
  82.  Befehl  : FILES
  83.  Aufgabe : Anforderung eines oder mehrer Files aus der Box
  84.  
  85.  Ähnlich REQUEST kann man mit FILES Nachrichten aus der Box anfordern, ohne
  86.  sie online aus der Box saugen zu müssen. Dabei stehen im Nachrichtentext
  87.  die Filenamen der gewünschten Files, zeilenweise untereinander.
  88.  Anstatt eines Filenamen kann auch eines der folgenden Schlüsselworte
  89.  benutzt werden :
  90.  
  91.    ALLFILES  sendet eine Liste aller über FILES zugänglichen Files
  92.    HELP         sendet den Hilfstext
  93.  
  94.  
  95.  Im Unterschied zu REQUEST können hierrüber nur Binärnachrichten angefordert
  96.  werden, die in der "FileRequest-Liste" stehen, d.h. der Befehl kann nur auf
  97.  bestimmte, vom Sysop markierte Bretter zugreifen, unabhängig von Ihren son-
  98.  stigen Zugriffsrechten.
  99.  
  100.  Dieser Befehl ist lediglich aus Kompatibilität zum ZC-MAPS Standard imple-
  101.  mentiert, es wird empfohlen, den Befehl REQUEST zu benutzen.
  102.  
  103.  
  104.  Befehl  : INDEX
  105.  Aufgabe : auflisten des Inhalts eines Bretts
  106.  
  107.  INDEX generiert eine standarisierte Liste des Inhalts eines Bretts. Dabei
  108.  wird für jede Nachricht ein ZConnect Header erzeugt, der die wichtigsten
  109.  Daten wiedergibt.
  110.  
  111.  Hinweis : Da ANUBIS momentan technisch noch nicht in der Lage ist, alle
  112.            ZConnect(tm) Header zu verwalten, kann nicht der komplette
  113.            Header wiedergegeben werden. Dies wird aber so bald wie mög-
  114.            lich geändert.
  115.  
  116.  
  117.  Befehl  : INHALT
  118.  Aufgabe : auflisten des Inhalts eines Bretts
  119.  
  120.  Der Befehl INHALT liefert den Inhalt eines Bretts zurück. Der Aufbau der
  121.  Liste entspricht dem des alten ANUBIS-MAPS und ist nicht standarisiert.
  122.  Der Befehl existiert nur aus Kompatibilität zum alten MAPS, für eine
  123.  standarisierte Liste benutzen Sie bitte den Befehl 'INDEX'.
  124.  
  125.  
  126.  Befehl  : HELP
  127.  Aufgabe : Zurücksenden des Hilfstextes
  128.  
  129.  HELP macht nichts anderes, als diesen Text an den User zurückzusenden.
  130.  Dies wird auch dann gemacht, wenn ein für MAPS unbekanntes Kommando
  131.  geschickt wurde.
  132.  Dieser Befehl kann auch über das Schlüsselwort "HILFE" ausgelöst
  133.  werden.
  134.  
  135.  
  136.  Befehl  : LIST
  137.  Aufgabe : generiert eine Liste aller für Sie zugänglichen Bretter
  138.  
  139.  Der Befehl LIST erstellt eine Liste derjenigen Bretter, die in der Mailbox
  140.  für Sie zugänglich sind. Dabei besitzt die Liste einen festgelegten
  141.  Aufbau, der durch alle Pointprogramme, die nach ZC-MAPS Standard arbeiten,
  142.  automatisch ausgewertet werden kann.
  143.  Der Listenaufbau ist folgendermassen definiert (Auszug aus ZC-MAPS Be-
  144.  schreibung) :
  145.  
  146.        Pos. 1:         Steuerzeichen
  147.        Pos. 2:         ASCII 32
  148.        Pos. 3ff:       Brettname bis zum CR/LF oder White Space.
  149.                        White Space dient als Trenner für die
  150.                        optionale Brettbeschreibung.
  151.  
  152.        Die Länge einer Zeile ist nicht begrenzt!.
  153.  
  154.        Steuerzeichen:  '+'     Brett ist derzeit bestellt.
  155.                        '-'     Brett ist nicht bestellbar.
  156.                        ' '     Brett ist nicht bestellt, bestellbar.
  157.                        '!'     Brett ist bestellt, kann aber nicht
  158.                                abbestellt werden (Zwangsanschluβ).
  159.                        ';'     Zeile enthält einen Kommentar.
  160.  
  161.  Anmerkung : Unter "White Space" versteht man eine beliebig lange Kom-
  162.          bination von Leerzeichen (ASCII 32) und Tabulatorzeichen
  163.          (ASCII 9).
  164.  
  165.  
  166.  Befehl  : PASSWORT
  167.  Aufgabe : Ändern des Point-Passwortes
  168.  
  169.  Hin und wieder will man als Point-Betreiber sein Passwort in der Box än-
  170.  dern. Hierfür ist dieses Kommando gedacht.
  171.  Es erwartet im Nachrichten-Text genau zwei Zeilen. In beiden Zeilen muβ
  172.  das neue Passwort stehen, es wird geprüft, ob Zeile1 = Zeile2 ist. Nur
  173.  im Gleichheitsfall wird das Passwort geändert.
  174.  
  175.  
  176.  Befehl  : REQUEST
  177.  Aufgabe : Bestellen einer Nachricht
  178.  
  179.  REQUEST bietet die flexibelste Möglichkeit, Nachrichten aus Brettern in der
  180.  Box zu bestellen. Im Nachrichten-Text stehen folgende Angaben über die
  181.  bestellten Files :
  182.  
  183.   <brettname> <File1> <File2> usw.
  184.  
  185.  Es können also in einer Zeile mehrere Files aus dem gleichen Brett bestellt
  186.  werden.
  187.  
  188.   <brettname> ist der Brettname, beginnend mit einem '/'.
  189.   <Filex>     der Name, die Brettnummer oder die MsgID einer Nachricht, die
  190.           bestellt werden sollen. Die sicherste Methode, die richtige
  191.           Nachricht zu bekommen, ist die MsgID, gefolgt vom Betreff
  192.           der Nachricht (Filename) und der Nummer.
  193.  
  194.  Alle Angaben werden durch ein Leerzeichen (ASCII 32) voneinander getrennt.
  195.  Die bestellen Files werden mit der jeweiligen Brettzuordnung bereitge-
  196.  stellt, ein Protokoll über die angeforderten Files wird an den Pointuser
  197.  verschickt.
  198.  
  199.  
  200.  Befehl  : SET
  201.  Aufgabe : Änderung der Parameter für den eigenen Point
  202.  
  203.  Ihr Point setzt sich aus vielen Parametern zusammen, die für den Betrieb
  204.  wichtig sind. Hin und wieder müssen diese Parameter veränderten Situationen
  205.  angepasst werden. Dies geht entweder nur in Rücksprache mit dem Sysop
  206.  oder halt mit dem Kommando 'SET'.
  207.  
  208.  Im Nachrichtentext stehen zeilenweise Schlüsselworte gefolgt von dem
  209.  neuen Wert für die jeweilige Einstellung.
  210.  
  211.  Folgende Schlüsselworte sind definiert :
  212.  
  213.   protokoll=<proto>    ; Ändert das Übertragungs-Protokoll Ihres Points
  214.               auf das angegebene Protokoll. Dieses Protokoll
  215.               muβ in der Liste des Systems existieren.
  216.  
  217.   setuserdate=Ja|Nein    ; Ja: Beim Anruf des Points wird das User-Datum
  218.                   auch gesetzt.
  219.  
  220.   sendstat=Ja|Nein    ; Ja: Für jeden einsortierten Puffer Ihres Points
  221.                   wird eine Sortierstatistik erzeugt und mit
  222.                   dem nächsten NetCall an Sie verschickt.
  223.  
  224.  Die Werte von fehlenden Schlüsselworten werden nicht verändert.
  225.  
  226.  Beispiel-Nachricht :
  227.  
  228.   protokoll=zmodem
  229.   sendstat=ja
  230.  
  231.  
  232.  Als Antwort erhalten Sie ein Protokoll über alle Änderungen.
  233.  
  234.  Hinweis : Sollten das Protokoll nicht in den System-Listen existieren,
  235.         so werden die jeweiligen Einstellungen nicht verändert. Dies
  236.         kann so Problemen im Pollbetrieb führen (keine Übertragung 
  237.         möglich) !
  238.  
  239.  
  240. 3. Besondere Hinweise
  241. ---------------------
  242.  
  243.  a) Es kommt hin und wieder vor, daβ ein Sysop aus technischen Gründen
  244.     ein Brett in der Box anders benennen muβ als im Netz. Sie als Point
  245.     bekommen aber immer den wirklichen Brettnamen. MAPS kann aber beide
  246.     Brettnamen auswerten. Wenn Sie den Originalnamen benutzen, setzt
  247.     MAPS den Namen entsprechend um, mit dem Boxnamen geht das sofort
  248.     ohne Probleme.
  249.  
  250.  b) Im Allgemeinen wird MAPS sofort nach dem Logoff Ihres NetCalls ausge-
  251.     führt und bearbeitet Ihre Nachrichten und stellt die Ergebnisse in-
  252.     nerhalb von ein paar Sekunden zur Verfügung.
  253.     Dies kann aber durch den Sysop geändert werden (einmal täglich oder
  254.     alle paar Stunden). Informieren Sie sich bitte bei Ihrem Sysop,
  255.     wenn Sie keine Antwort von MAPS bekommen (Sie bekommen in jedem
  256.     Fall, also auch bei Fehlern, eine Antwort.
  257.  
  258.